home *** CD-ROM | disk | FTP | other *** search
/ Belgian Amiga Club - ADF Collection / BS1 part 43.zip / Lijst javago.adf / HyperCat1.30.doc < prev    next >
Text File  |  1988-07-13  |  8KB  |  166 lines
  1.                       Hypercat  1.30 software/disk cataloger.
  2.                             By Ian Wu. (C) Feb 1988.
  3.  
  4.    The cataloger can be run from Workbench or from the CLI. It will open
  5. a 2 colour screen using your Workbench's foreground/background colours.
  6. Use the menus or keyboard shortcuts to select functions. Both PAL and
  7. NTSC machines are supported (Pal owners get about 5 extra lines of info).
  8.  
  9.    Note: For CLI users, if you have lots of directories to read,
  10.          you may need to use 'Stack 10000' before running HyperCat.
  11.  
  12.    The cataloger's format consists of three fields:
  13.       1 - The program's name (max 30 chars)
  14.       2 - The program's type eg. Educational (max 20 chars)
  15.       3 - The disk number (1 - 9999)
  16.    A maximum of 5000 programs is allowed. (This may be increased if
  17. a suitable donation accompanies the request, HINT, HINT).
  18.    On the title bar of the screen, you will see the current number of
  19. records in the catalog, and also the current record range being displayed.
  20.  
  21.                                  Project Menu
  22.    Open - Opens a catalog and merges (appends) it to the end of the current
  23.           catalog (if there's already one in memory). A file requester will
  24.           appear, and you may either:
  25.              1 - Type in the file name (and optionally the drawer and disk)
  26.              2 - Click on a file, then click OK
  27.              3 - Double click on the file
  28.              4 - Click the Cancel button to abort the selection
  29.    Save - Save the catalog under a name, you may select the name of the
  30.           file in the same way as when opening it.
  31.    New  - Clear the catalog. You'll get a requester asking you
  32.           to confirm your request.
  33.    Quit - Quits the program what else?
  34.  
  35.                                    Sort Menu
  36.    Name - Sorts the catalog in alphabetical order under program name.
  37.    Type - As above for the type field.
  38.    Disk Number - Ditto for disk numbers.
  39.  
  40.                                    Find Menu
  41.    Name - Finds a particular program name or group of names. This is case
  42.           sensitive. Type in a name (or close to cancel). If it exists, it
  43.           will be displayed on the top line in highlight. Alternatively,
  44.           you may give a wild card specification as follows:
  45.             * - matches any number of characters
  46.             ? - matches a single character
  47.           Eg. a*b - find programs starting with lower case 'a' and ending
  48.                     with lower case 'b'
  49.               co? - find program names starting with 'co' with one
  50.                     character after it (co1, cod co3, coo etc)
  51.           In this case, no name will be highlighted, but all matches if
  52.           any will be moved to the top of the screen (and the top of
  53.           the catalog, so you may have to re-sort the catalog).
  54.    Type - As above for program type.
  55.    Disk Number - As above for a range of disk numbers. You'll be asked
  56.           to enter the lowest and largest range of disk numbers to
  57.           search for (or click on close to cancel).
  58.           Eg. from 12 to 33 - search for programs with disk numbers
  59.               between 12 and 33 inclusive.
  60.    Repl. Type - Allows you to change the type of a program (by doing a
  61.           search and replace). You will be asked to enter the program
  62.           type you want to change, then the type you want it to be.
  63.           Then you will receive a requester asking for a global
  64.           replacement or not. If you choose OK! then all occurrences of
  65.           the first type you entered will be changed to the second type
  66.           automatically. If you choose CANCEL! then you will be prompted
  67.           to type Y (for yes) if you want to change the type, or N
  68.           (for no) if not. The appropriate record will be highlighted on
  69.           the top line to show the record HyperCat is looking at.
  70.  
  71.                                   Delete Menu
  72.    Name -        }
  73.    Type -        } As above but delete any matches.
  74.    Disk Number - }
  75.  
  76.                                   Insert Menu
  77.    Record - Click on cancel to cancel. Otherwise enter the program name,
  78.             type and disk number and click on ok. The program will be
  79.             inserted at the end of the catalog. If the displayed range
  80.             (see title bar) is not at the end, you won't see the
  81.             new record.
  82.    Disk -   You will be asked to give the disk number and the
  83.             volume/drive name you want to read, or click on close to
  84.             cancel. The entire contents of the disk and all
  85.             directories/subdirectories will be read and program files
  86.             will be inserted into the catalog. The type field for each
  87.             of these programs will default to 'Command'. You can change
  88.             this later by editing the record(s).
  89.             You can also read starting from a specific directory by
  90.             giving the name of that directory, like 'DF1:MyDir/'
  91.             (Note that you must type the trailing slash). Hypercat will
  92.             start reading from that directory and all its subdirectories.
  93.    Exclude .info files - You can toggle this selection on and off. If
  94.             you select this (menu will have a tick next to it), all
  95.             files ending in '.info' will be ignored and not inserted.
  96.             This is the default mode.
  97.  
  98.                                   Display Menu
  99.    Forward - Moves you forward a page at a time through the catalog.
  100.              A page is the maximum number of lines that can fit on the
  101.              screen (about 23 for PAL machines, 18 for NTSC).
  102.    Backward - Takes you backwards a page at a time.
  103.    Top -     Goes to the top of the catalog.
  104.    Bottom -  Goes to the bottom of the catalog.
  105.  
  106.              Alternatively, you may use the up/down arrow keys to scroll
  107.              up or down the catalog one line at a time.
  108.  
  109.                                   Print Menu
  110.    Name - Enter the range of records to print (defaults to all records),
  111.           or click close to cancel. For example from 2 to 6 prints just
  112.           records 2 to 6. You can use preferences to change to condense
  113.           mode printing (don't forget to set pitch and margins). In
  114.           this case, Hypercat will print in 3 columns.
  115.           You can press the SPACE bar to stop the printing.
  116.    Name/Disk Number - As above, but prints name and disk number.
  117.    Name/Type/Disk Number - As above but a single record per line with all
  118.           three fields.
  119.  
  120.           In 'normal' mode, your printer must be capable of 80 columns,
  121.           and in 'condense' mode, 132 columns.
  122.  
  123.                                    Editing
  124.    To edit a particular record, just double click on a record. If the
  125. record is already highlighted, then just click once on it. You may edit
  126. the record or cancel. Any record you click on will stay highlighted until
  127. the next find/edit or sort operation. You may also delete a file by
  128. clicking once on a record and then selecting delete name on the menu. To
  129. unselect a record which is highlighted, move the mouse pointer down
  130. either below the last record (if the page isn't full), or as far down
  131. the screen as it will go and click once.
  132.  
  133.    Whenever you perform any edit/insert or a find operation with wild
  134. cards, the catalog may not be in sort order anymore. What you see on
  135. the display is the order they are stored on the catalog. So you may
  136. want/need to choose sort again before saving the file.
  137.  
  138.     Disk.cat is provided as an example catalog.
  139.  
  140.  
  141.  
  142.                               ADDITIONS:
  143.    Note for those who have purchased previous versions of HyperCat
  144. (ie. V1.1 or V1.11), there is a utility accessible only from the CLI
  145. called HyperConvert. Use this program to convert catalogs created by
  146. V1.1 or V1.11 HyperCat into the faster loading format of V1.20 and V1.30.
  147. Note that it may run quite slow, so don't think that it's gone to lunch!
  148. Usage from CLI is as follows:
  149.  
  150.    HyperConvert <oldfile> <newfile>
  151.       where oldfile is your old catalog, and newfile is the new format.
  152.  
  153.  
  154.  
  155.    Please direct criticisms/comments/donations/praise etc to:
  156.  
  157.                       HyperCat
  158.                       P.O. BOX 231
  159.                       Burwood
  160.                       3125
  161.  
  162.    Upgrades or requests to customize a cataloger will be answered only
  163. if accompanied by MONEY! ($20 or more preferably). Upgrades will cost
  164. about $5 - $10 depending on whether its a program bug or a real upgrade.
  165. (Send a blank disk too, if upgrading).
  166.